Zum Hauptinhalt springen
POST
[BETA] Campaign Performance Forecasts

Autorisierungen

Authorization
string
header
erforderlich

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Body

application/json

Public API request for a listing campaign performance forecast.

campaignFormat
enum<string>
erforderlich

Campaign format type. Currently only 'listing' is supported.

Verfügbare Optionen:
listing
dailyBudget
number
erforderlich

Daily budget for the campaign

dateRange
PublicDateRange · object
erforderlich

Campaign date range

targetRoas
number
erforderlich

Target Return on Ad Spend

campaignType
enum<string>
erforderlich

Campaign type (required)

Verfügbare Optionen:
autobidding
products
PublicProductRequest · object[]
erforderlich

List of products in the campaign (required)

Minimum array length: 1
triggers
PublicTriggerRequest · object[]

List of campaign triggers (optional, defaults to empty list)

targets
enum<string>[] | null

Optional list of target variables to forecast. If not provided, all targets will be forecasted.

Verfügbare Optionen:
ad_spend,
clicks,
impressions,
purchases,
sales

Antwort

Successful Response

forecasts
PublicCampaignForecastMetrics · object
erforderlich

Campaign performance forecasts